<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- The HTML 4.01 Transitional DOCTYPE declaration-->
<!-- above set at the top of the file will set     -->
<!-- the browser's rendering engine into           -->
<!-- "Quirks Mode". Replacing this declaration     -->
<!-- with a "Standards Mode" doctype is supported, -->
<!-- but may lead to some differences in layout.   -->

<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    <title>CSE-587-Yin-Yan-Project1</title>
  </head>

  <body>
    <h1>Available web services</h1>
	<p>
		All web services are Restful API, use xml as extension will return xml formated data, json as extension will json return json formated data.
		<br />
		Without extension, system will display html human readable interface.
	</p>
    <ul>
    	<li>
    		<h4>Given a country name, return the UN country code and capital.</h4>
    		<p>
    			{root}/myapp/country/uncodeAndCapital/{countryName}
    			<br />
    			<a href="myapp/country/uncodeAndCapital/china">exampe: {root}/myapp/country/uncodeAndCapital/china</a> |
    			<a href="myapp/country/uncodeAndCapital/china.xml">XML</a> | 
    			<a href="myapp/country/uncodeAndCapital/china.json">JSON</a>
    		</p>
    	</li>
    	
    	<li>
    		<h4>Given lat/long as input tell me which country I am in. </h4>
    		<p>
    			{root}/country/findCountryByCoordinates?lat={lattitude}&long={longtitude}
    			<br />
    			<a href="myapp/country/findCountryByCoordinates?lat=50&long=50">exampe: {root}myapp/country/findCountryByCoordinates?lat=50&long=50</a> |
    			<a href="myapp/country/findCountryByCoordinates.xml?lat=50&long=50">XML</a> | 
    			<a href="myapp/country/findCountryByCoordinates.json?lat=50&long=50">JSON</a>
    		</p>
    	</li>
    	
    	<li>
    		<h4>Given 2 country names determine if they are bordering each other. </h4>
    		<p>
    			{root}/myapp/country/isBorder?country1={countryName1}&country2={countryName2}
    			<br />
    			<a href="myapp/country/isBorder?country1=china&country2=south_korea">exampe: {root}/myapp/country/isBorder?country1=china&country2=south_korea</a> |
    			<a href="myapp/country/isBorder.xml?country1=china&country2=south_korea">XML</a> | 
    			<a href="myapp/country/isBorder.json?country1=china&country2=south_korea">JSON</a>
    		</p>
    	</li>
    	
    	<li>
    		<h4> Top ten list: Provide a list of countries with top 10 in Population, GDP, Overall land area (size)and Human development index.</h4>
    		<h4> Bottom ten list: repeat the above for countries at the lower end of these statistics. </h4>
    		<p>
    		{root}/myapp/country/countryList/{featureName}?order="{order}"
    		<br />
    		<span>feature:GDP, HDI, POPULATION, LANDAREA</span><br />
    		<span>order:desc --- Top10; asc --- Bottom10</span><br />
   			<a href="myapp/country/countryList/GDP?order=desc">exampe: {root}/myapp/country/countryList/GDP?order=desc</a> |
   			<a href="myapp/country/countryList/GDP.xml?order=desc">XML</a> | 
   			<a href="myapp/country/countryList/GDP.json?order=desc">JSON</a>
    		</p>
    	</li>
    	
    	<li>
    		<h4> Given a country, display its map and list its capital. </h4>
    		<p>
    		{root}/myapp/country/displayMap/{countryName}"
    		<br />
   			<a href="myapp/country/displayMap/china">exampe: {root}/myapp/displayMap/china</a> |
   			<a href="myapp/country/displayMap/china.xml">XML</a> | 
   			<a href="myapp/country/displayMap/china.json">JSON</a>
    		</p>
    	</li>
    	
    	<li>
    		<h4> Given a city C and its coordinates {x,y}, determine all capital cities accessible by land from that city including the one in the same country as the city. Next find the closest capital city from the city C excluding the capital city of the country in which C is located. </h4>
    		<p>
    		{root}/myapp/country/searchByCity/{cityName}?lat={lat}&lng={longtitude}"
    		<br />
   			<a href="myapp/country/searchByCity/onecityinKazakhstan?lat=50&lng=50">exampe: {root}/myapp/country/searchByCity/beijing?lat=50&lng=50</a> |
   			<a href="myapp/country/searchByCity/onecityinKazakhstan.xml?lat=50&lng=50">XML</a> | 
   			<a href="myapp/country/searchByCity/onecityinKazakhstan.json?lat=50&lng=50">JSON</a>
    		</p>
    	</li>
    	
    	<li>
    		<h4> Provide a feature to classify the countries into N groups (3< N < 10) where N is user specified.  While various parameters can be used for classification, we will use only population. </h4>
    		<p>
    		{root}/myapp/country/classification?groupNumber={number}"
    		<br />
   			<a href="myapp/country/classification?groupNumber=5">exampe: {root}/myapp/country/classification?groupNumber=5</a> |
   			<a href="myapp/country/classification.xml?groupNumber=5">XML</a> | 
   			<a href="myapp/country/classification.json?groupNumber=5">JSON</a>
    		</p>
    	</li>
    </ul>
  </body>
</html>
